草庐IT

Rust 注释

全部标签

c# - Visual Studio 2015 缺少 XML 注释/文档

是我还是VisualStudio2015中的System.Linq缺少XML注释?因为我仍然可以在MSDN上找到它.但是在键入时,例如,这段代码:varlist=newList();list.Select(IntelliSense不为System.Linq命名空间中的任何类/方法/成员/扩展提供注释/文档:这是在EnumerableAlt+)F12gotodefinition随机扩展方法时的预览:我想我也没有注意到VisualStudio2013中的文档。但我确实记得他们曾经在那里,也许那是在VisualStudio2012或更早的版本中?编辑:我忘了说我在VisualStudio20

c# - 使用 Arrange-Act-Assert 进行单元测试时是否推荐标题注释?

我发现按照AAA模式中的建议对单元测试语句进行分区的概念很有用。我倾向于添加标题注释,以便测试看起来像这样://Arrangeinta=1;intb=2;//Actintc=a+b;//AssertAssert.AreEqual(3,c);但我很好奇,总是包含这些标题注释是否正常?...或者这是我应该避免的事情?inta=1;intb=2;intc=a+b;Assert.AreEqual(3,c); 最佳答案 一旦理解了基本前提,这似乎并没有增加太多值(value)。既然你提到了C#,我建议看看TheArtofUnitTesting

c# - 从源文件中删除所有注释(单行/多行)和空行

这个问题在这里已经有了答案:RegextostriplinecommentsfromC#(6个答案)关闭3年前。如何从C#源文件中删除所有注释和空行。请记住,可能会有嵌套的评论。一些例子:stringtext=@"//notacomment";//acomment/*multilinecomment*/stringnewText="/*notacomment*/";//acomment/*multiline//notacomment/*comment*/stringanotherText="/*notacomment*///sometexthere\"//notacomment";//

c# - 在 Visual Studio 中快速注释/* 选定的 C# 代码 */(不是//整行)

VisualStudio有一个工具栏按钮/键盘快捷键/菜单项commentsoutselectedlinesofC#code使用//。是否有使用/*...*/注释掉仅选定代码的等效项?例如给定这段代码strings="hello";Console.WriteLine(s+"world");如果您选择+"world"并按下Ctrl+K,Ctrl+C然后你得到strings="hello";//Console.WriteLine(s+"world");不过,我想strings="hello";Console.WriteLine(s/*+"world"*/);当我在修复一些错误的同时对现有代

c# - 您应该对私有(private)方法进行 XML 注释吗?

所以我在我的代码中使用XML注释来帮助解释公共(public)方法和公共(public)成员,另一位开发人员提到并非我的所有方法都有XML注释。我使用的规则是,如果是公共(public)的或protected,则添加XML注释,如果是私有(private)的,则不添加。这听起来合乎逻辑吗?或者有什么理由让您将XMLComment设为私有(private)方法? 最佳答案 关于评论没有严格的规定,但我认为评论公共(public)/内部/protected方法是好的。有时我会在私有(private)方法不是很清楚的时候注释它们。理想情况

c# - 使用数据注释标记字段 "Read Only"

我正在尝试将ID字段设置为只读。它是数据库中的一个身份字段,因此用户不会设置它。然而,他们愿意看到它。当分配给DataForm时,我遗漏了什么仍然允许编辑该值。publicclassStatusChoice:BindableBase{privateintid;[Key,DatabaseGenerated(DatabaseGeneratedOption.Identity)][Editable(false,AllowInitialValue=false)]publicintID{get{returnid;}set{id=value;OnPropertyChanged();}}}

c# - 在 C# 中读取 XML 注释

我有一些在节点上方包含注释的XML文件。当我读入文件时,作为过程的一部分,我也想删除注释。我知道您可以使用XmlComment向文件写入注释,但不确定如何读回它们。我的XML看起来与此类似: 最佳答案 试试这个:XmlReaderSettingsreaderSettings=newXmlReaderSettings();readerSettings.IgnoreComments=false;using(XmlReaderreader=XmlReader.Create("input.xml",readerSettings)){XmlD

c# - <example></example> XML 注释标记 : how to see it?

我使用MicrosoftVisualStudio2012。当我将代码示例放入C#类/方法的XML注释中时,我想知道:引用我的程序集的用户将如何看到该代码示例?我试图引用我自己的程序集,我找到的唯一方法是:查看assembly.xml文件。我可以安装VisualStudio或其他任何软件来查看这些代码示例吗?这是我在评论中添加的内容://////Thisismymethodexample//////////////Hereismycodeexample.Callmymethodlikethis:///constinta=10;///MethodExample(a);//////publi

c# - Visual Studio 2015/C# 6/Roslyn 无法编译 PCL 项目中的 XML 注释

我刚刚安装了最新发布的VisualStudio2015社区版(RTM),我正在尝试获取myopensourceproject在VS2015和C#6.0下工作。我的一些.cs跨项目共享。这样我就可以构建PCL版本(功能有限)和核心库的“完整”版本。然而,出于某种原因,某些代码文件在完整项目中构建正确,但在PCL项目中构建时失败(所有内容均在C#5和VisualStudio2013下编译)。构建PCL版本时,编译器似乎无法解析XML注释中的cref。这是一个在我的机器上失败的简化代码示例:///publicclassA{//Compileerroronnextline:///.public

c# - 使用 .NET CodeDom 代码生成时如何自定义自动生成的注释?

我正在使用CodeCompileUnit和CSharpCodeProvider生成一些源代码。它将下面的header添加到所有生成的代码中。有没有办法自定义评论以表达其他内容?////Thiscodewasgeneratedbyatool.//RuntimeVersion:2.0.50727.3053////Changestothisfilemaycauseincorrectbehaviorandwillbelostif//thecodeisregenerated.// 最佳答案 你不能。我建议在此之后立即添加您自己的评论。这是一个